home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 8 / runmen3.zip / RUNMENU.DOC < prev    next >
Text File  |  1988-08-29  |  13KB  |  362 lines
  1. .QQ
  2. .R:Q
  3. .X:5
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                    Runmenu Menu Interface Documentation
  14.  
  15.  
  16.  
  17.  
  18.                                  for the
  19.  
  20.  
  21.  
  22.                          IBM PC/XT/XT286/AT/PS-2
  23.  
  24.  
  25.  
  26.  
  27.                       Revised Date:  29 August 1988
  28.  
  29.  
  30.  
  31.  
  32.                                Produced by 
  33.  
  34.  
  35.  
  36.  
  37.                           Laney and Associates 
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.      Copyright (c)  Laney and Associates, 1988  as an unpublished 
  48.      share work.  All rights reserved.  This work is the property 
  49.      of Laney and Associates and may not be appended to, modified 
  50.      or copied (except as described in this document) without the 
  51.      express written consent of Laney and Associates. 
  52. 
  53. .H:     Runmenu Interface Documentation                  29-AUGUST-88
  54. .H:
  55. .F:
  56. .F:     Table Of Contents
  57. .N:1
  58.  
  59.      Table Of Contents
  60.  
  61.  
  62.      Section     Title                                       Page
  63.      ------------------------------------------------------------
  64.  
  65.  
  66.      Introduction                                               1
  67.  
  68.           Runmenu Purpose                                       1
  69.  
  70.           Runmenu Features                                      1
  71.  
  72.           Runmenu Support                                       1
  73.  
  74.  
  75.      Initialization                                             2
  76.  
  77.           Initial Setup                                         2
  78.  
  79.           Definition File Setup                                 2 
  80.  
  81.  
  82.      Execution                                                  5
  83.  
  84.           DOS Command execution                                 5
  85.  
  86.           Sub-Menu execution                                    6
  87.  
  88.           Utility-Menu execution                                6
  89.  
  90.      Errors                                                     7
  91.  
  92.      Editorial Comment                                          7
  93.  .N:1
  94. .F:...Page -$$$...
  95.  
  96.  
  97.      Runmenu Purpose
  98.  
  99.           For  many users relating to DOS commands and  answering 
  100.      prompts can be time wasting and very cumbersome.  Runmenu is 
  101.      a  simple menu driven program that allows keystrokes  to  be 
  102.      recorded in a definition file and be passed to a DOS  shell. 
  103.      It  is the purpose of Runmenu to take the day to day tedious 
  104.      nature  of  running programs and batch files away  from  the 
  105.      user. 
  106.  
  107.  
  108.      Runmenu Features
  109.  
  110.           In  release  3.0  of Runmenu Sub-menu  support,   timed 
  111.      execution, batch file support,  a quick menu modification, a 
  112.      windom zoom feature and many other options have been  added.   
  113.      This  is  in addition to  support   for   CGA/EGA  monitors, 
  114.      pause after a DOS command,  execution of a Sub-menu from   a  
  115.      command    line,     the  ability  to   list   and    change  
  116.      directory support and file print options. 
  117.  
  118.      Runmenu Support
  119.  
  120.           Currently,  there is no support for Runmenu (this could 
  121.      change).   This is a share work project.  
  122.  
  123.           This  project represents many hours of work.    If  you 
  124.      find this program useful,  a  small contribution of $8  U.S.
  125.      would be appreciated.  Please share and distribute copies of 
  126.      this  program  with friends and associates providing  it  is 
  127.      distributed in its orginal form with no modifications.   Any 
  128.      mail, questions or inquiries can be forwarded to: 
  129.  
  130.  
  131.         David O. Laney
  132.         Post Box 31218
  133.         Overlook Station
  134.         Dayton, Ohio 45431-0218
  135.         U.S.A.   
  136.      
  137.      
  138.  
  139.      Initial Setup
  140.  
  141.           Runmenu  unlike other menu programs requires no special 
  142.      directory setup.  In fact a user can customize and create as 
  143.      many  DOS  command Definition Files as  desired.   To  point 
  144.      Runmenu  at  a  particular  directory which  will  hold  the 
  145.      documentation  and  definition file  include  the  following 
  146.      statement in the autoexec.bat file: 
  147.  
  148.  
  149.           SET RUNDEF=x:\y\runmenu.def
  150.           x:\y\runmenu
  151.  
  152.           where:
  153.  
  154.           x   represents the drive where the runmenu.def and the
  155.               runmenu.doc file resides.
  156.  
  157.           y   represents the sub-directory for the runmenu.def and
  158.               runmenu.doc reside.
  159.               (this may be omitted or expanded if necessary)
  160.  
  161.  
  162.      Once  the  autoexec.bat has been changed,  at system  bootup 
  163.      time the  appropriate  directory will be searched to  prompt 
  164.      the  appropriate menu selections.  If the above statement is 
  165.      not included  Runmenu  willassume the current directory  for 
  166.      the executable and definition file. 
  167.  
  168.  
  169.      Definition File Setup
  170.  
  171.  
  172.      To setup a menu for a particular IBM PC/XT/AT/PS-2   system, 
  173.      use an ascii text editor on the runmenu.def file. 
  174.  
  175.      The file should have the following setup:
  176.  
  177.  
  178.      Max-Menu-Entries   Foreground-Color-#           Background-Color-#
  179.      Program-Name       Executable  Param-1~Param-2  Directory-or-N
  180.      Program1~Name      Executable  Param-1~Param-2  Directory-or-N
  181.      Program2~Name      Executable  Param-1~Param-2  Directory-or-N
  182.      +Sub~Menu~1~Name   X           X                Full-Menu-Path-name
  183.      +Sub~Menu~2~Name   X           X                Full-Menu-Path-name 
  184. 
  185.  
  186.      An example of a typical runmenu.def file is as follows:
  187.  
  188.      07  03  01
  189.      Root~Directory     DIR               C:\*.*    P
  190.      Root~Directory-2   DIR               *.*       P
  191.      Root~Directory-3   DIR               N         C:\
  192.      Program~Typical    PROGRAM1          ARG1~ARG2 C:\PRLIB
  193.      Program~Batch      PROGRAM2          N         C:\BATLIB
  194.      Program~Another    \PRG\AREA\PAN     PAN       N
  195.      +Menu~One          X                 X         C:\MENU\M.DEF 
  196.  
  197.      In the example above, the menu has seven entries. At startup 
  198.      it uses menu color 3 (Cyan foreground)  for normal intensity 
  199.      and menu color 1 (Blue background) for the background color. 
  200.      The  next  three lines of the example show how to execute  a 
  201.      "DIR"   by use  of three different methods.  The fourth line 
  202.      indicates  how to run a  typical  program  in  the directory 
  203.      "C:\PRLIB"  and pass  a command-line argument to it. (Please 
  204.      Note,   that "N"   is used as  a  place  holder  to  skip  a 
  205.      directory  or  command-line argument field and that "P"   in 
  206.      the directory argument  field  allows  for  pausing  at  the 
  207.      command  has executed.)  A  Tilda "~"  is used to indicate a 
  208.      space.  At runtime,  the tilda "~"  is substituted  so  that 
  209.      as  many  parameters  as  pssible   may   be  passed  to  an 
  210.      executable program.  The seventh line indicates how to enter 
  211.      a  menu  entry that uses the "\MENU\M.DEF"  as a  definition 
  212.      file. 
  213.  
  214.      Parameter             Explanation 
  215.  
  216.      Max-Menu-Entries -    The number of program and sub-menu 
  217.                            combinations in a definition file.
  218.                            (Numeric).
  219.  
  220.      Foreground-Color-# -  The color (0-15) to be used with the
  221.                            foreground. (Numeric).
  222.  
  223.      Background-Color-# -  The color (0-15) to be used with the
  224.                            background. (Numeric).
  225.  
  226.                            Color-Number     Color-Number
  227.                              0  Black         8  Blink-Black
  228.                              1  Blue          9  Blink-Blue
  229.                              2  Green        10  Blink-Green
  230.                              3  Cyan         11  Blink-Cyan
  231.                              4  Red          12  Blink-Red
  232.                              5  Purple       13  Blink-Purple
  233.                              6  Orange       14  Blink-Orange
  234.                              7  White        15  Blink-White
  235. 
  236.  
  237.      Parameter             Explanation (continued)
  238.  
  239.      Program-Name -        The Name of the program  or  Menu.  A
  240.                            tilda "~" is used to indicate a space
  241.                            (Alpha-Numeric [space terminates])
  242.  
  243.      Executable -          A batch file, or program executable
  244.                            to run (".EXE", ".COM", or ".BAT"). 
  245.  
  246.      Param-1/Param-2 -     A parameter to pass to an executable.
  247.                            Note, that a tilda "~" can  be  used  
  248.                            to separate Parameter 1 from 2.
  249.  
  250.      Directory -           Runmenu will temporarily change to 
  251.                            this directory before running the
  252.                            executable (Full path name).
  253.  
  254.   
  255.  
  256.      DOS Command execution
  257.  
  258.           Runmenu can be executed through the DOS Command shell 
  259.      by passing four arguments on the command line. The format 
  260.      for this arguments are as follows:
  261.  
  262.      RUNMENU  menu-title  not-used  not-used  definition-file
  263.  
  264.  
  265.      Parameter             Explanation 
  266.      
  267.      Menu-title -          The title of the opening menu. A tilda
  268.                            "~" is used to indicate a space.
  269.  
  270.      Definition-File -     The name of a Runmenu definition file.
  271.                            (Full path name).
  272.  
  273. 
  274.      Sub-Menu execution
  275.  
  276.           To create a sub-menu a '+' must be entered in the first 
  277.      position of the Menu-title name.  The fourth (4th) parameter 
  278.      is  the  full  path  name of a  definition  file.   At  Menu 
  279.      execution  the  current  definition file is closed  and  the 
  280.      window  explodes  when a new definition file is opened.   If 
  281.      there is an error in a definition file unpredictable results 
  282.      will occur.  The following example shows the format of seven 
  283.      menu entry.    
  284.  
  285.      07  04  07
  286.      +Menu~One          X           X         C:\MENU\M1.DEF 
  287.      +Menu~Two          X           X         C:\MENU\M2.DEF 
  288.      +Menu~Three        X           X         C:\MENU\M3.DEF 
  289.      +Menu~Four         X           X         C:\MENU\MM.001 
  290.      +Menu~Five         X           X         C:\MENU\MM.002 
  291.      +Menu~Six          X           X         ..\MENU\MM.BAK 
  292.      +Menu~Seven        X           X         D:\DOS\RUNMENU.DEF 
  293.  
  294.      Utility-Menu execution
  295.  
  296.           The Utility Menu is invoked with the 'U' command off of 
  297.      the main Runmenu.  Each of the utilities work independent of 
  298.      each  other  to  provide the user with a set  of  tools  for 
  299.      convient   use.    The  options  are  as  follows  are  self 
  300.      explanatory. 
  301.  
  302.  
  303.           Runmenu Utility Options:
  304.  
  305.           Q - Quick-Modify (for minor changes).
  306.           H - Displays the Help menu.
  307.           D - Executes the DOS-Shell.
  308.           B - Changes the PC Border Color (CGA only).
  309.           C - Changes the current directory.
  310.           L - Lists the contents of a directory.
  311.           M - Displays the maximum PC memory available.
  312.           N - Displays the Share Program Notice.
  313.           P - Prints a file on LPT1:
  314.           R - Returns to the main selection menu.
  315.           S - Searches the current set Path(s) to find a particular file.
  316.           T - Displays the time.
  317.           V - Displays the current version of Runmenu.
  318.           Z-  Zoom mode - (Moves windows around).
  319.           X - Timed Execution.
  320.           E - Exits Runmenu (on utility menu - causes complete exit).
  321. 
  322.  
  323.      Errors
  324.  
  325.           The  following  Runmenu errors are documented  for  the 
  326.      convience of the user: 
  327.      
  328.       
  329.      Definition File [?] not found ! - This is caused when the 
  330.                                        file does not exist, or 
  331.                                        file name is mispelled on
  332.                                        command line or menu.
  333.                                        Perhaps RUNDEF is not set
  334.                                        and def file is not in the
  335.                                        current directory.
  336.  
  337.      Invalid Start Time !            - The start time for a timed
  338.                                        execution is incorrect.
  339.  
  340.  
  341.      Editorial Comment
  342.  
  343.           Since the release of version 1.2 of Runmenu, I have had 
  344.      several favorable comments. It has been my priveledge to see 
  345.      Runmenu  running on several machines of whom people did  not 
  346.      know that I was the author.  Runmenu is meant to be a shared 
  347.      executable  that is to be used for the convience of any  one 
  348.      who  wants  to.  There is no intention on the part  of  this 
  349.      author  to  compete  with,  win glorious  praise,   or  gain 
  350.      national fame.   Also,  the author claims no  responsibility 
  351.      for  any damages,  destruction or problems caused with  your 
  352.      computer  as  a result of using Runmenu.  Version  3.0   was 
  353.      written  to  address many problems,  but with  particular to 
  354.      allowing multiple arguments to be passed to programs. If you 
  355.      enjoy  using this product and want to contact me - you  have 
  356.      my address on page 1. 
  357.      
  358.      Thank you for your attention to this product,
  359.  
  360.      David O. Laney
  361.  
  362.